SPHINX-QUICKSTART(1) | Sphinx | SPHINX-QUICKSTART(1) |
NAME¶
sphinx-quickstart - Sphinx documentation template generator
SYNOPSIS¶
sphinx-quickstart
DESCRIPTION¶
sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build(1).
OPTIONS¶
- -q, --quiet
- Quiet mode that skips the interactive wizard for specifying options. This option requires -p, -a and -v options.
- -h, --help, --version
- Display usage summary or Sphinx version.
Structure Options
- --sep
- If specified, separate source and build directories.
- --no-sep
- If specified, create build directroy under source directroy.
- --dot=DOT
- Inside the root directory, two more directories will be created; “_templates” for custom HTML templates and “_static” for custom stylesheets and other static files. You can enter another prefix (such as “.”) to replace the underscore.
Project Basic Options
- -p PROJECT, --project=PROJECT
- Project name will be set. (see project).
- -a AUTHOR, --author=AUTHOR
- Author names. (see copyright).
- -v VERSION
- Version of project. (see version).
- -r RELEASE, --release=RELEASE
- Release of project. (see release).
- -l LANGUAGE, --language=LANGUAGE
- Document language. (see language).
- --suffix=SUFFIX
- Source file suffix. (see source_suffix).
- --master=MASTER
- Master document name. (see master_doc).
Extension Options
- --ext-autodoc
- Enable sphinx.ext.autodoc extension.
- --ext-doctest
- Enable sphinx.ext.doctest extension.
- --ext-intersphinx
- Enable sphinx.ext.intersphinx extension.
- --ext-todo
- Enable sphinx.ext.todo extension.
- --ext-coverage
- Enable sphinx.ext.coverage extension.
- --ext-imgmath
- Enable sphinx.ext.imgmath extension.
- --ext-mathjax
- Enable sphinx.ext.mathjax extension.
- --ext-ifconfig
- Enable sphinx.ext.ifconfig extension.
- --ext-viewcode
- Enable sphinx.ext.viewcode extension.
- --ext-githubpages
- Enable sphinx.ext.githubpages extension.
- --extensions=EXTENSIONS
- Enable arbitrary extensions.
Makefile and Batchfile Creation Options
- --use-make-mode (-m), --no-use-make-mode (-M)
- Makefile/make.bat uses (or doesn’t use) make-mode. Default
is use, which generates a more concise Makefile/make.bat.
Changed in version 1.5: make-mode is default.
- --makefile, --no-makefile
- Create (or not create) makefile.
- --batchfile, --no-batchfile
- Create (or not create) batchfile
Project templating
New in version 1.5: Project templating options for sphinx-quickstart
- -t, --templatedir=TEMPLATEDIR
- Template directory for template files. You can modify the templates of sphinx project files generated by quickstart. Following Jinja2 template files are allowed:
- master_doc.rst_t
- conf.py_t
- Makefile_t
- Makefile.new_t
- make.bat_t
- make.bat.new_t
In detail, please refer the system template files Sphinx provides. (sphinx/templates/quickstart)
- -d NAME=VALUE
- Define a template variable
SEE ALSO¶
COPYRIGHT¶
2007-2023, Georg Brandl and the Sphinx team
November 21, 2023 | 3.4.3 |